home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / slam18.zip / SLAM.DOC < prev    next >
Text File  |  1992-02-29  |  12KB  |  291 lines
  1.  
  2.                       ------------------------------------
  3.                       Searchlight Alias Maker (SLAM) V.1.8
  4.                       ------------------------------------
  5.  
  6.                                By: Greg Belanger
  7.                            Late-Night Software, Inc.
  8.                          The Arcade BBS (403) 273-3503
  9.                                    (c) 1992
  10.  
  11.  
  12.  
  13. =-=-=-=-=-=-=
  14. What is SLAM?
  15. =-=-=-=-=-=-=
  16.  
  17. SLAM is for SLBBS V.2.15+ And is *NOT* compatible with any version prior
  18. to version 2.15...It was tested with 2.15C, but should work with any other
  19. 2.XX ugrade version.  I strongly recommend you switch to the LATEST version
  20. of SLBBS to be sure.  SLAM uses 1 or 2 files, depending on the Sysops needs.
  21. As a start, YOU MUST have an Aliases.Txt file present before SLAM will
  22. run.  Aliases.Txt will be automatically appended with each new users
  23. Real Name and Alias.  The basic purpose of SLAM is to automatically
  24. update this file (as well as OPTIONALLY update Alias.Def for SL)
  25. each time a New User registers on your system.
  26.  
  27. SLAM was written as an ADDITION to another program I recently released
  28. called RENAME.  Anyone familliar with Glen Johnson's SLRENAME program
  29. will recognize RENAME's purpose -- to change Alias names to Real names
  30. on EXPORT and Real names to Alias names on IMPORT to the SL subboards.
  31. RENAME uses the Aliases.Txt file as a DATA file in changing the
  32. names in the .MSG files.  Previous versions of SLAM had SUPPORT for
  33. SLRENAME...This is no longer the case.  From v.1.7 on, SLAM will
  34. ONLY work with RENAME.  Glen Johnson never has shown support for a
  35. utility for SLRENAME, so I have DISCONTINUED support.
  36.  
  37. SLAM is a simple little program that will save Sysops who allow ALIASES alot
  38. of time.  I don't like the idea of MANUALLY adding a user's name AND alias
  39. to a the Aliases.Txt file EACH time a New User registers.
  40. SLAM does it automatically.  SLAM is a simple program which can be placed
  41. in the NEW USER autodoor or Autodoor BATCH FILE to question the user
  42. about an alias.  SLAM will send the sysop a message with the info
  43. (Users real name, Alias and if they did not REGISTER with an ALIAS,
  44. SLAM will notify the sysop that a NAME CHANGE is necessary).
  45. As well, it OPTIONALLY adds the Alias to the Searchlight ALIAS.DEF file.
  46. It will also check for a DUPLICATE name before adding that name to the
  47. files.  Simple.
  48.  
  49. ** You MUST be using RENAME to use SLAM.  As well, you must have an
  50. ALIAS.DEF file for SL.  SLAM no longer supports SLRENAME (Any version).
  51. In short, you MUST have the Aliases.Txt AND Alias.Def files before SLAM
  52. will work! **
  53.  
  54.  
  55. =-=-=-=-=-=-=-=
  56. Setting up SLAM
  57. =-=-=-=-=-=-=-=
  58.  
  59. Setting up SLAM is SUPER-EASY.  You only need to pass it five parameters:
  60. (Use the NEW USER Autodoor or place it in a BATCH FILE)
  61.  
  62.  
  63. Param 1:  Users Name (Use %U)
  64. Param 2:  C, M or N Ansi (Use %G)
  65. Param 3:  The Sysop's account name (Spaces replaced by underscores)
  66. Param 4:  Y or N for whether you want SLAM to add the Alias to ALIAS.DEF
  67. Param 5:  The DIR/PATH of ALIASES.TXT and ALIAS.DEF files, you
  68.           *MUST* use a trailing backslash after the DIR\PATH
  69.  
  70. Set the COMM Support to STANDARD, ABORT method to TERMINATE or 
  71. REBOOT and WRITE PROTECT to NO.  If you have trouble with SLAM
  72. hanging when carrier is dropped, you may have to EXPERIMENT with
  73. the COMM and ABORT methods based on your configuration.
  74.  
  75.  
  76. ** YOU MUST HAVE ALIASES.TXT CREATED BEFORE SLAM WILL RUN! **
  77.  
  78. ** ALIAS.DEF NEED ONLY BE CREATED IF YOU WANT SLAM TO ADD THE NEW USERS
  79.    ALIAS TO ALIAS.DEF (Fourth command-line parameter) **
  80.  
  81.  
  82. EXAMPLE #1:
  83.  
  84. SLAM %U %G SYSOP Y C:\BBS\
  85.                        ^
  86.                     Don't forget the trailing backslash at the
  87.                     end of the path!
  88.  
  89. --This will load SLAM with the current users name, graphics mode, send the
  90. message to SYSOP and will look for and use the ALIASES.TXT and ALIAS.DEF
  91. files in C:\BBS\.  It WILL Add the users Alias to ALIAS.DEF as
  92. indicated by the "Y" as the fourth parameter.
  93.  
  94.  
  95. EXAMPLE #2:
  96.  
  97. SLAM %U %G MERLIN_THE_MAGICIAN N D:\SLBBS\NODE1\
  98.  
  99. --This will load SLAM with the current users name, graphics mode, send the
  100. message to MERLIN THE MAGICIAN and will look for and use the ALIASES.TXT
  101. file in D:\SLBBS\NODE1\.  It WILL NOT Add the users Alias to ALIAS.DEF,
  102. as indicated by the "N" as the fourth parameter.
  103.  
  104.  
  105. EXAMPLE #3 (Batch File--Loaded by the NEW USER Autodoor):
  106.  
  107. NEWUSER.BAT
  108. @Echo Off
  109. CLS
  110. SLAM.EXE %1 %2 SYSOP Y C:\BBS\   <---- Make sure you call NEWUSER.BAT
  111.                                        with %U %G on the line
  112.                                        Ex: NEWUSER.BAT %U %G
  113.  
  114. That's it.  Pretty straight-forward.
  115.  
  116.  
  117. =-=-=-=-=-=-=-=-=
  118. The SYSOP Account
  119. =-=-=-=-=-=-=-=-=
  120.  
  121. Dont forget:  If you use a name with more than one word, such as MERLIN THE
  122. MAGICIAN, you *MUST* replace the spaces with underscores.  So that SLAM
  123. reads the WHOLE name.  Don't forget now...
  124.  
  125.  
  126. =-=-=-=-=-
  127. Sysop Mail
  128. =-=-=-=-=-
  129.  
  130. SLAM automatically sends the sysop a notice that the new user has chosen to
  131. use an alias, and provides that ALIAS as well as their REAL name.  If the
  132. user DID *NOT* register with an ALIAS, obviously SLAM does diddly-squat!
  133. I chose to add a warning message to the sysops notice if the user
  134. DIDN'T use an alias at registration.  This way, the Sysop can manually
  135. change that account name to the proper alias name.  The user is also
  136. notified of this.  I was thinking of doing it AUTOMATICALLY, but to be
  137. perfectly frank (no pun intended), I have no idea how to make SL do this,
  138. nor do I have a desire to spend that much time on this sort of utility.
  139. Hopefully, if you have "Name" changed to "Alias <or> Real Name" in your
  140. strings file for the New User registration screen, not too many users will
  141. have a problem.
  142.  
  143.  
  144. =-=-=-=-=-=-=-=-=-
  145. The Future of SLAM
  146. =-=-=-=-=-=-=-=-=-
  147.  
  148. Hopefully there wont be a future for SLAM.  I would much rather have an
  149. ALIAS routine BUILT-IN to SLBBS. Let's all bug Frank some more, ok?  :-)
  150. SLAM and RENAME go hand-in-hand.  If you do not have RENAME, you can
  151. get it from any of the Addresses listed at the end of this DOC.
  152.  
  153.  
  154.  
  155. -=-=-=-=-=-=
  156. DRDOS USERS:
  157. -=-=-=-=-=-=
  158.  
  159. It may be necessary to load SLAM in the following manner when dealing with
  160. DRDOS. First, indicate your COMMAND.COM path and load SLAM with the /C
  161. option, or just add .EXE to the end of SLUF and it should run.
  162.  
  163. EX: (Using the example format above)
  164.  
  165. C:\COMMAND.COM /CSLAM %U %G SYSOP Y C:\BBS\
  166.  
  167. <<OR>>
  168.  
  169. SLAM.EXE %U %G SYSOP Y C:\BBS\
  170.  
  171. (Apparently DRDOS needs the .EXE extension of the filename.)
  172.  
  173.  
  174. =-=-=-=-=-=-=-=
  175. Error Messages:
  176. =-=-=-=-=-=-=-=
  177.  
  178. In the event that the Searchlight Config files cannot be found or are
  179. damaged, SLAM will inform the user by flashing the appropriate message.
  180. Standard messages that may be displayed in the event of an error are:
  181.  
  182. CONFIG FILE ERROR -- CONTACT SYSOP
  183. SUBBOARD ERROR -- CONTACT SYSOP
  184.  
  185. These will only be displayed if the files are DAMAGED or are NOT FOUND.
  186.  
  187.  
  188. -=-=-=-=-=-
  189. Disclaimer:
  190. -=-=-=-=-=-
  191.  
  192. While this program may not be completely bug-free, I have done significant
  193. testing to ensure that all MAJOR bugs have been squashed.  I do NOT
  194. guarantee that this software will run properly, nor will I be responsible
  195. for any damage that may occur to your computer hardware or software while
  196. using SLAM.  I feel that SLAM is relatively safe to run.   All the
  197. safeguards possible have been installed to provide maximum security for your
  198. system and files while SLAM is in operation.
  199.  
  200. SLAM was tested ONLY with MSDOS 5.0, if you encounter problems with SLAM,
  201. please discontinue using the product and inform me.  I will do my best
  202. to correct the problems.  SLAM *SHOULD* run fine under IBM DOS
  203. and MSDOS 3.0 or later.  DRDOS users, please see the section ABOVE about
  204. loading SLAM under DRDOS.
  205.  
  206.  
  207. -=-=-=-=-=-
  208. About SLAM:
  209. -=-=-=-=-=-
  210.  
  211. I have been programming in Pascal for several years.  It started with my
  212. first introduction to Turbo Pascal 4.0 in High School and I have continued
  213. to enjoy (sometimes!) programming various personal utilities and programs in
  214. my spare time.  I have tried virtually every SL 3rd party utility in
  215. existance.  I HATE messing with ALIAS programs, and I wanted a quick and
  216. EASY solution to the current ALAIS hassle.  So, here it is!  Thankfully
  217. there is already a good RENAME utility to do all the dirty work (RENAME).
  218.  
  219. As you might have guessed, SLAM is written entirely in Turbo Pascal
  220. version 6.0, and incorperates several TPU's from Frank LaRosa's great
  221. SL Programmer's Library kit.
  222.  
  223.  
  224. -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  225. A Word About 3rd Party-ware:
  226. =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  227.  
  228. Over the last couple of years,  I have noticed more and more authors
  229. DEMANDING payment for programs they create.  While I understand the work put
  230. into these BBS 'helpers' I am distressed by the fact that BBS operators
  231. should have to CONTINUOUSLY and NEVER-ENDINGLY pay for these utilities.
  232. That's why I choose to write FREE-WARE.  I support the idea of a bbs, where
  233. utilities and programs are shared.  Bbs operators are an amateur group
  234. of hobbyists and I don't believe a BBS operator should have to continuously
  235. pay for a hobby he/she already pays enough for.  The BBS operator is a fine
  236. species..One who allows people he/she doesn't even know to gain access to
  237. their system, out of the goodness of his/her heart.  I ask all you authors
  238. who are so valuable to the Searchlight community to join me in providing
  239. all our fellow SL sysops with quality FREE-WARE.  Donate some of your time
  240. and expertise to the cause...It'll make the BBS community a much better
  241. place!
  242.  
  243.  
  244. =-=-=-=-=-=-=-=-=
  245. Closing Comments:
  246. =-=-=-=-=-=-=-=-=
  247.  
  248. SLAM is FREE.  COMPLETELY FREE.  I ask no fee for using this software, but I
  249. do however ask that you do NOT modify the file, or crack (dis-assemble) the
  250. code in any manner.  If you find this program of value, and you want to
  251. contribute something, by all means send whatever you feel is fair.  My real
  252. payment is that you find this program of value, and I thank you for taking
  253. the time to read about SLAM.  If you have any problems, bug reports, general
  254. questions or concerns, please address them to the following address:
  255.  
  256.                                Greg Belanger
  257.                          3241 Doverville Crescent S.E.
  258.                              Calgary, Alberta
  259.                                   CANADA
  260.                                   T2B1V1
  261.  
  262.             ...Or contact me at any of these Network Addresses:
  263.  
  264.                            1:134/48  -- FidoNet
  265.                          201:5500/48 -- MetroNet
  266.                           99:9305/48 -- EggNet
  267.                          250:420/750 -- SL_Net
  268.  
  269.  
  270.            ...Or Call my bbs at (403) 273-3503  (24 Hours & HST)
  271.  
  272.  
  273.      ** The LATEST Version of SLAM is ALWAYS File Requestable as SLAM **
  274.  
  275.  
  276.                    Thanks for taking an interest in SLAM!
  277.  
  278.  
  279.  
  280. -------------------------------------------------------------------------------
  281. Created with Searchlight Programmer's Library
  282. Portions Copyright (c) 1991 Searchlight Software And Frank LaRosa
  283. SEARCHLIGHT, SL & SLBBS are registered trademarks of Searchlight Software, Inc.
  284. RENAME is copyrighted by Greg Belanger and Late-Night Software, Inc.
  285. SLRENAME is copyrighted by Glen Johnson 1:269/101@FidoNet
  286. MSDOS is a registered trademark of Microsoft, Inc.
  287. IBM is a registered trademark of International Business Machines, Inc.
  288. TURBO PASCAL & TP are registered trademarks of Borland International.
  289. DRDOS is a registered trademark of Digital Research, Inc.
  290. -------------------------------------------------------------------------------
  291.